Specifying configuration properties

The AMMSection control can be configured using Meridian Explorer properties. These properties can be specified in the file <Meridian Explorer>\applications\Meridian Explorer\properties\Meridian Explorer.properties.

The AMMSection control uses the following properties:

• amm.rootURL – This is the URL through which the Meridian Explorer pages can be seen. For example:

amm.rootURL=http://<ServerName>/ExplorerClient/home.aspx
?VIEWID<DocViewID>&DOCFILTER=<DocFilterID>&TAGFILTER=<TagFilterID>
&NAVSTATE=HIDE

• amm.additionalkeys.<Application> – This section contains the argument values to be used in the filter for the specified Maximo application. By default, the AMMSection control will add the indexed keys of the currently selected object to the query string of the link page. For example: ?asset=11430 for an asset or ?location=BR351 for a location. With the amm.additionalkeys parameters, additional search keys can be added per Maximo application.

  For example:

amm.additionalkeys.location=site=SITEID;location=LOCATION
amm.additionalkeys.asset=site=SITEID;location=LOCATION
amm.additionalkeys.wotrack=site=SITEID;asset=ASSETNUM

The keys location, asset, and wotrack refer to columns in the table of the Maximo database where the main data for the selected object are stored.

For example, when an asset is selected, the documents related to the asset location can be added to the search result by setting the parameter:

amm.additionalkeys.site=BEDFORD&location=BR450 

Note    Prior to Meridian Asset Management Module 2012, the most common way to map assets to objects and documents in Meridian Enterprise was by using multivalue arguments that were concatenated by a separator, for example, location=BEDFORD-BR450. Since version 2012, this configuration can be simplified by using single value arguments, for example, location=BR450&site=BEDFORD.

Meridian Explorer supports both ways for compatibility with prior Asset Management Module configurations. However, because single values arguments are more intuitive and transparent, this guide and the default configuration files use single value arguments by default. For Maximo 5 integration, only multivalue argument examples are shown because we assume that way is the most useful for Maximo 5 users. For more examples, see Link document query strings for Maximo 5.x and the default configuration files.

In another example, the following parameter will add location and asset documents to a work order:

amm.additionalkeys.wotrack=location=SITEID-LOCATION;asset=SITEID-ASSETNUM  

In this example, two additional search keys are added. Multiple search keys can be configured by separating them by a semicolon.

Note    The specific URL that is created by Control.jsp, and the values of the amm.additionalkeys and amm.rootURL properties will differ with each implementation. Therefore, it is important that the person installing the module know how to modify the JavaScript controls in Maximo.